package com.oos.zone.wechat.cp.service;

/**
 * 功能描述：
 *
 * @author 拓金辉
 * @version 1.0
 * @date 2021-08-08 11:56:03
 */
public interface WxCpEventNoticeService {

    /**
     * 方法描述：微信通知事件
     *
     * @param corpId       路径参数，企业id
     * @param agentId      路径参数，应用id
     * @param msgSignature 从接收消息的URL中获取的msg_signature参数企业微信加密签名，msg_signature结合了企业填写的token、请求中的timestamp、nonce参数、加密的消息体
     * @param timestamp    从接收消息的URL中获取的timestamp参数
     * @param nonce        从接收消息的URL中获取的nonce参数
     * @param encryptedXml 从接收消息的URL中获取的整个post数据
     * @return java.lang.String
     * @author 拓金辉
     * @date 2021-07-30 14:37:07
     */
    String notice(String corpId, String agentId, String msgSignature, String timestamp, String nonce, String encryptedXml);

    /**
     * 方法描述：验证URL有效性
     *
     * @param corpId       路径参数，企业id
     * @param agentId      路径参数，应用id
     * @param msgSignature 从接收消息的URL中获取的msg_signature参数企业微信加密签名，msg_signature结合了企业填写的token、请求中的timestamp、nonce参数、加密的消息体
     * @param timestamp    从接收消息的URL中获取的timestamp参数
     * @param nonce        从接收消息的URL中获取的nonce参数
     * @param echoStr      从接收消息的URL中获取的echostr参数
     * @return java.lang.String
     * @author 拓金辉
     * @date 2021-07-30 14:37:07
     */
    String verify(String corpId, String agentId, String msgSignature, String timestamp, String nonce, String echoStr);

}
